home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu493.dms / pu493.adf / AMOSEyes_Docs < prev    next >
Text File  |  1992-09-02  |  12KB  |  245 lines
  1.  
  2.                                A M O S E Y E S
  3.  
  4.                        (c) Lee Bamber of Digital Ninja
  5.  
  6.  
  7.  Origional Completion Date: 10-APR-1993         V1.0.0 Released: 17-Apr-1993
  8.  
  9.  
  10. -----------------------------------------------------------------------------
  11.                The AMOSEyes Viewer V1.0.0 is PUBLIC DOMAIN
  12. -----------------------------------------------------------------------------
  13.  
  14.  Utilities of any sort can be real nasty peices  of  work  if  not  properly
  15.  explained.  And AMOSEYES deserves a good going over before you start asking
  16.  all those un-anticipated questions.  So what is AMOSEyes?
  17.  
  18.  AMOSEyes is an advanced Text Reader using  the  latest  in  user  interface
  19.  controls,  found in leading text-viewers.  But what sets this one apart  is
  20.  it`s ability to bring in your own graphics and place them around your docs.
  21.  
  22.  Furthermore, it offers a Selector Screen that gives the potential user  the
  23.  chance to skip the instructions altogether and continue with whatever  your
  24.  disk is suppose to do.
  25.  
  26.  So what IS your disk suppose to do?  Well, the primary use I am advertising
  27.  this utility for is Game Instruction Manuals.  Other uses easily follow but
  28.  the advantages of a doc reader like AMOSEyes give  those  Amateur  and  Pro
  29.  Game writers an alternative to Just Text!  Your game  already  is  full  of 
  30.  graphics of a sort, so why not make the whole production professional!
  31.  
  32.  What about copyright and stuff?  Well, this one is easy.  AMOSEyes the View
  33.  Program is Public Domain and freely distributable.  It`s also freely usable
  34.  and freely advertisable.  In fact you could completely fail to  mention  me
  35.  as it`s author and still get away with it!  Go ahead.  My  job  has  paused
  36.  for the time being.  Now it`s up to you to spread the thing as far and wide
  37.  as possible.  The more people see it, the more might want one of there  own
  38.  to head their creations.  And that then comes back to me.  Because  I  have 
  39.  the AMOSEyes Editor!
  40.  
  41.  What Editor?  Now, this little peice of digital engineering is  the  centre
  42.  peice of AMOSEyes.  Without it, the viewer may as well retire.  The Editors
  43.  main job is to create AMOSEyes Files (The .DOC file you can  find  on  your
  44.  disk).  As there is only one of these files per disk, as soon as the viewer
  45.  is called, it will seek out this file on the current disk and  present  it!
  46.  
  47.  The AMOSEyes Editor will be Shareware as I find this to be the best way  to
  48.  get payed for my time.  As Shareware, updates will become a regular  thing.
  49.  New developments are begging to be implemented.  Things you  just  wouldn`t
  50.  believe!  Moving illustrations, Actual moving ships or  characters  to  try 
  51.  the controls of a game and even reference highlighters that  go  into  more
  52.  detail on a word or title.  The expansion potential of such a fresh utility
  53.  will require much support from eeger beavers.  Who knows, maybe this  could
  54.  spark the first interactive instruction manual!  Now that is  what  I  call
  55.  real communication!
  56.  
  57.  This has not been designed to replace the text viewer in any  way!    Those
  58.  are still the most convenient way to convey alot of information in a  small
  59.  space.  What this does do is offer the user a booklet on disk.   Take   for
  60.  example, you buy a game and you get your instruction book  and  some  cards 
  61.  with little messages and offers on.  You flick through it straight  to  the
  62.  controls section and swot up on how to fire or punch or whatever. Some even
  63.  read the story line and get a real feel of the situation.  Well AMOSEyes is
  64.  the perfect vehicle.  It`s new, it supports graphics, but more importantly,
  65.  it`s easy to use.
  66.  
  67.  But it isn`t just Game Writers who can  rub  their  hands  at  this  point,
  68.  for this thing can be used for all sorts of stuff.  Write a Manual for  one
  69.  of your coverdisk collections.  Port over a load of graphics into  one  big
  70.  picture and do a spot of index writing and you have a complete tour of your
  71.  entire disk collection.  Make a picture book of your favourite subject like
  72.  insects or aircrafts, throw in a heap of facts  and  figures  and  bang,  a 
  73.  minature reference book.  Compile a healthy pile of your amateur  work  and
  74.  present it using AMOSEyes.  Send it to a PD Library and you have  you  name 
  75.  in lights!
  76.  
  77.  Well basically that`s it.  You know what AMOSEyes is for  and  I  hope  you 
  78.  find a use for it!  If you want to see what the creator of this can do, get
  79.  hold of any Digital Ninja Game created after March 1993.  I hope you  enjoy
  80.  the exploits of this potential giant of a utility.
  81.  
  82.  
  83. -----------------------------------------------------------------------------
  84.                               * AMOSEYES VIEWER *
  85.  
  86.  
  87.  The viewer is riddled with things to move you through the instruction  book
  88.  as effortlessly as possible.  Primarily on the off chance that the user has
  89.  not bothered to read the instructions and  just  experimented  his/her  way
  90.  through the controls.  Well for those who want the lot, read on.
  91.  
  92.  
  93.  Using `AMOSEyes` on your disk
  94.  
  95.  Firstly, there are two ways of using AMOSEyes.  The first is to click on it
  96.  from the Window in the workbench.  The second is using the CLI call to  the
  97.  program `AMOSEyes`.  If you do not know the basics about preparing your own
  98.  disk for automatic boot-up, you can skip to the end of this section now for
  99.  a quick read up on it.  Now, assuming you know basically what the  startup-
  100.  sequence is used for, you can put the line,
  101.  
  102.  :AMOSEyes [RETURN]
  103.  
  104.  in the `startup-sequence` file and when you boot your disk,  AMOSEyes  will
  105.  then load and you will nicely proceed to the next stage.
  106.  
  107.  When initialising your own disks, you can put the AMOSEyes Program in the C
  108.  Directory.  Then all you do is call AMOSEyes  from  your  startup-sequence!
  109.  
  110.  The Selection
  111.  
  112.  When you are in the Selection Screen.  That is the one with the two  boxes,
  113.  marked `The Instructions` and `Continue`.  Clicking the continue will  exit
  114.  AMOSEyes and return to the workbench or continue with lines from the  start
  115.  up-sequence.  However, by selecting `The Instructions`, AMOSEyes will  then
  116.  load the Viewer.
  117.  
  118.  
  119.  The Viewer
  120.  
  121.  The viewer is layed out to present icons along the top of the main  screen,
  122.  a page indicator down the right side of the screen and the main display bit
  123.  that shows your text and graphics.
  124.  
  125.  Top Icons > | ABOUT | MORE | BACK | PMORE | PBACK | QUIT |
  126.  
  127.  ABOUT - By clicking* on this, the author name and credits will be shown for
  128.  about 15 seconds, then will refresh the viewer.
  129.  
  130.  MORE - By holding down** this, the current page will scroll down at  medium
  131.  speed until it reaches the end of the page.  At which time, the scroll will
  132.  stop.
  133.  
  134.  BACK - Same as the MORE control, but the screen scrolls back up the current
  135.  page at medium speed until the top of the page is reached.  Holding down**,
  136.  the mouse button will operate this control.
  137.  
  138.  PMORE - This is a Page More Control.  It means to turn the page to the next
  139.  one and position the display at the top of the new current page.  This will
  140.  increment the current page number.  When no more pages remain, this  option
  141.  will no longer function.  To operate this control, click* it.
  142.  
  143.  PBACK - Same as BACK is to MORE, PBACK will turn to the  last  page  number
  144.  and will cease to work when there are no pages to turn back to.  To operate
  145.  this control, simply click*.
  146.  
  147.  QUIT - Click* this to exit the Viewer.
  148.  
  149.  * Clicking refers to pressing the Left Mouse Button Once and then releasing
  150.    it.
  151.  
  152.  ** Holding  Down  refers  to  holding  down  the  Left  Mouse  Button   and
  153.     sustaining the hold until it is felt that the command has  been  carried 
  154.     out to the satisfaction of the user.
  155.  
  156.  
  157.  The Page Indicator is a simple device.  It will draw a single dash  between
  158.  the top and the bottom of the space allocated.  The top represents the  top
  159.  of the Instruction Book and the bottom refers to the bottom of the Book. By
  160.  looking at the position of the dash, the user has  an  idea  of  where  the
  161.  current page is situated in the book.
  162.  
  163.  
  164.  And there`s more...
  165.  
  166.  By moving the mouse arrow pointer inside the display part of the screen and
  167.  pressing the left mouse button once, the shape of the arrow will change. It
  168.  will now point up or down.  By moving this arrow within the  display  area,
  169.  first up then down, you will see the text/graphic display will scroll as it
  170.  nears the top and bottom.  This is especially useful for slow reading  like
  171.  you see in the closinng credits of a series or film.
  172.  
  173.  
  174.  Also...
  175.  
  176.  The viewer has keyboard support aswell.  The arrow keys on the  keyboard, I
  177.  am so sorry A600 users(maybe in a later version!), will do the following:
  178.  
  179.  Arrow Up - Moves the text/graphic display toward the top of the page  at  a
  180.  high rate of speed.  Useful for a quick re-read of something.   The  scroll
  181.  will stop when the top of the page has been reached.
  182.  
  183.  Arrow Down - Moves the text/graphic display toward the bottom of  the  page
  184.  until it hits the bottom at which time the scroll will stop.  This  too  is
  185.  high speed for text skimming.
  186.  
  187.  Arrow Right - Exactly the same as the | PMORE | control above. It turns the
  188.  page to the next highest number until there are no more pages to see.
  189.  
  190.  Arrow Left - Exactly the same as the | PBACK | control above. It  turns  to 
  191.  the previous page number until there are no more pages to turn back to.
  192.  
  193.  
  194.  There are plenty of different ways to achieve the same goal.  Find the  one
  195.  you like best and stick with it.  I hope you  find  no  problems  with  the 
  196.  selection of controls.  If you have your own preference, then please write,
  197.  and inform us and we will get to work(if it`s really clever!).
  198.  
  199.  
  200. -----------------------------------------------------------------------------
  201.              <- Space Reserved for Later Version Instructions ->
  202. -----------------------------------------------------------------------------
  203.                           * UTILITY SPECIFICATIONS *
  204.  
  205.  Information on all aspects of AMOSEYES Versions and updates  to  appear  in
  206.  this section as updates become available.
  207.  
  208.  Program Requirements:
  209.  
  210.    V1.0.0   - 512k Minimum(no fast required)
  211.               Single Internal Floppy Drive
  212.  
  213.  Program Compatability:
  214.  
  215.    17/04/93 - Test successful on the A500 & A1200
  216.  
  217.  Program Spec and Size:
  218.  
  219.    V1.0.0   - "AMOSEyes" = Main program for Instruction Book = 90k
  220.               "AMOSEyes.DOC" = Text and graphic vectors = (any)
  221.               "AMOSEyes.PIC" = Standard IFF picture(4 Colour,Lowres) = (any)
  222.  
  223.  Notes:
  224.  
  225.    *1 - The AMOSEyes.DOC and AMOSEyes.PIC must remain with the AMOSEyes Main
  226.         Program at all times otherwise the AMOSEyes Program will not execute
  227.         the Viewer.  Also, the two datafiles must reside in the Root of  the
  228.         Disk(The Main part of the disk, not in any directory!).
  229.  
  230.    *2 - When copying the AMOSEyes Viewer(PD) for a friend , could you please
  231.         throw over a copy of the docs as well(AMOSEyes_docs).  Do  not  copy
  232.         The Editor, it is copyright and is quite illegal to distribute! 
  233.  
  234.    *3 - The Updates `improvement quality` depends on solid response from you
  235.         so even if it`s a mere whim, write in to Digital Ninja!
  236.  
  237.    *4 - The three files for AMOSEyes (AMOSEyes, AMOSEyes.DOC, AMOSEyes.PIC),
  238.         must always be in the root of the device being presented.  As V1.0.0
  239.         only allows one doc per device, make sure you don`t erase over  your
  240.         last .DOC file!
  241.  
  242.    *5 - Game Writers should only need one Instruction Book File.  The  space
  243.         allowed is plenty enough for the grossest of Docs.  In Editor V1.0.1
  244.         at least!
  245.